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http://androidforum.com 
http://anddev.org 


Développons en Java ,jean-Micheal DOUDOUX. 


gan,‏ الله الرحمان الرحيم 


السلام عليكم و رحمة الله و براكاته ,لقد إنتهيت من كتابة الجزء 
الأول ' من كتاب المختصر المفيد في البرمجة بالأندرويد.هذا الجزء يحتوي 
على المفاهيم الأساسية بإضافة إلى بعض الأمثلة لمساعدة المبرمج على 
البدأ في elis‏ تطبيقات الأندرويد بكل سهولة. 

باختضار ,الجزء الأول عن الكتاب Bot, eas Be yb ey‏ تطوير 
البرمجيات. اكلبس و Gate Lo]‏ .تطوير البرمحيات اتدرويد الي تلك 
المنصة ثم يعطي شرحا وحيزة لهندسة برنامج أندرويد ,لينتهي هذا 
alioYl pau jad‏ التلبيفية لكيفية sly‏ تطبيفاك الاندرويد 
.و لكي لا أطيل عليكم ,أرجوا أن ينال هذا الكتيب إستحسانكم 


لتحميل هذا الكتاب بجميع أجزاءه ,زورا الموقع: 


http://alba99ali.wordpress.com 
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-1-1- ما هو الأندرويد ؟ 


الأندرويد هو برنامج لصنع البرمجيات من نوع مفتوح المصدر , يضم كل من 
Rene « Seat, ool a lat! does] elis ye osi duse‏ 
أ ندرو يد للمبرمجين بتطوير تطبيقات الهاتف الخلوي إستنادا إلى 

ask‏ البرمحة. GG‏ من خلال مجميعة من المكثيات. وادوات الفتمف لذالك 
ل re‏ الا تذزروية على نواة لينكس. 
اول ظهور للا تدرو يد كان في نو قمبر 2007 ب قا مت شركة 
ا سه هذا النظام DA‏ ,تم oo disan‏ وروا البرامج و 


المنضمين تحت لواء: 
Open Handset Alliance‏ 


و التي تضم بالإضافة إلى غوغل كل من: 
NTT DoCoMo,Sprint Nextel,HTC,....‏ 


Pees oo Giles ستغيلة على‎ 9 Sams اندرويد كعتاد‎ 


ARM (Advenced Risc Machine) 
ثم تم إعتماده‎ Acorn هذا المعالج تم تطويره خصيصا لحواسب شركة‎ 


يحضع "o x) 9525 VI‏ نوع a Cotte‏ اباتشي للبرمجيات الحرة 
المصدر في المقابل بمكنهم الأطلاع على شيفرة المصدر للمبرمجين الأخرين 

و قيام بتعديلات عليها بدون قيود. 

ap AN Aladi wa al dat e an Aa JE to 
التي لم تعد فقط مقتصرة على أجراء مكالمة هاتفية بل أصبحت تدعم أخر‎ 
الصيحات التكنولوجيا و المتمثلة في معدات مثل : الكاميرا,جهاز‎ 
قارىوء الوسائط المتعددة, نظام الإتصال بالأقمار الإصطناعية أو ما يعرف‎ 
إختصارا ب 65,الشاشة التي تعمل عن طريق اللمس ,الوي-في ,الخ‎ 

يعم النحكم في هدح المعداة عن طريق استدعاغة المكتيات الخاضة بها 


أن تكون لك تجربة في كتابة تطبيقات بللغة البرمجة جافا من الأحسن 
gl‏ تكون لك فكرة مسيقة حول صنع تطييقات. للهاتف. pl asi L deli‏ 

للغة جا فا Lol j2me‏ فة إلى ذالك مطلوب معر فة تقنية XML‏ لأن 

DOLL xs 935 VI‏ على XML based UI LAYOUT‏ لتسهيل وضع و تر ليب 
agziz SU gal!‏ المستخدم gerbil! Iolo‏ ]3493933 


4-1-لتسهيل البرمجة بالاندرويد ماذا تحتاج ؟ 


البرمجيات. المتكاملة المعرونة اختضار TO gs IDE-‏ 
Eclipse‏ , ميزة اكلبس أن هندسته تعتمد على معهوم | sl w Lò Loy‏ 
Plug in‏ حيث يتم إضافة الأندرويد إلى إطار عمل برمجيات اكلبس. 


5-1- قائمة الهواتف الخلوية التي تدعم نظام التشغيل الاندرويد 
إليكم بعض الهواتف الخلوية التي يتم تشغيلها على نظام التشغيل 
اندرويد : 
Acer Al.‏ 
ARCHOS Phone Tablet‏ 
Dell Mini 31‏ 
HTC Dragon‏ 
HTC Hero‏ 
Huawei U8230‏ 
Kogan Agora Pro‏ 
LG Etna‏ 
LG Eve‏ 
Motorola Droid‏ 
Motorola Heron‏ 
Samsung Bigfoot‏ 
T-mobile Gl‏ 
اليكم صورد بعض الهواتف الخلوية التي يتم تشغيلها على نظام التشغيل 

















تحميل وتثبيت الأ ندرويد 


du‏ 'تحميل. و SS GJI woe piti eua»‏ أن JRE als‏ موجود بجهارك لان 
اكلبس مثله مثل باقي تطبيقات المكتوبة بللغة جافا يحتاج الى 
JRE: java runtime environement‏ لكي يتم تشغيله, بنسبة لمن يريد تطوير 
التطبيقات بالإندرويد ,من اللازم تحميل إصادر الخامس أو فما فوق من 
ملف JRE‏ و الذي يمكن تحميله من موقع: 
http://developers.sun.com/downloads‏ 


Eclipse pulsSi ys was ماذا‎ 


اكلبس هو بيئة متكاملة لتطوير برمجيات 108 مكتوب Java lòl» all,‏ 
مجا ني و يخضع لترخيص مفتوح المصدر الذي يخضع له كذالك الأندرويد. 
بالاضاقة إلى pil cell‏ يدعم اكليس للخات الترمخة أخرى Ba LIL‏ 
pti, JE le‏ ارو 

غرم أن اكلبس مجاني و مفتوح المصدر إلا أنه غني بالوثائق التي تساعد 
على تطوير برمجيات و حل المشاكل التي قد Tio prot | Leer! qu‏ .و JX‏ 
بالذكر هنا بأن اكلبس يعمل بنفس الكفاءة على مختلف الاجهزة و انظمة 
التشغيل المختلفة . 


Eclipse wilS! ois 9 تحميل‎ 
اكلبس ثم اذهب إلى صفحة التحميل:‎ pÒ go qae 
http: //eclipse.org/downloads 


/> Eclipse Downloads - Windows Internet Explorer 


o. yo jÆ) eclipse.org ~al tx] Ə 


Fichier Edition — Affichage Favoris Outils ? 





Gp Favoris | 32» #8] O1Net # | Débuter avec IES #] ~ Æ| Hotmail # |] - 
és Eclipse Downloads fè v x | gen ” Page + Sécurité + Outils 
Home Downloads Users Members Committers Resources Projects About Us | Se 


Eclipse Downloads 


fou will need a Java runtime environment {JRE} to u 


Eclipse (Java 5 JRE recommended). All downloads sre 


provided under the terms and conditions of the Eclipse 
Foundation Software User Agreement unless otherwis 
Eclipse Packages Projects a ae 


Galileo Packages (based on Eclipse 3.5 SR1)- Compare Packages Looking for Older Versions or Source 


Eclipse IDE for Java EE Developers (189 MB) Windows 

Tools for Java developers creating Java EE and Web applications, including a Java IDE, Mac Carbon 32bit 

JEE tools for Java EE, JPA, JSF, Mylyn and others. More... Mac Cocoa 32bit 64bit 
Downloads: 540,850 Linux 32bit 64bit 


gi 


Eclipse IDE for Java Developers (92 MB) Windows 
The essential tools for any Java developer, including a Java IDE, a CVS client, XML Editor Mac Carbon 32bit 


and Mylyn. More... Mac Cocoa 32bit 64bit 
Downloads: 281,309 Linux 32bit 64bit 


Eclipse for PHP Developers (139 MB Windows 


Tools for PHP developers creating Web applications, including PHP Development Tools Mac Carbon 32bit CRYSTAL REPORTS 
(PDT), Web Tools Platform, Mylyn and others. More... Mac Cocoa 32bit 64bit FOR ECLIPSE 
Downloads: 126,661 Linux 32bit 64bit 


Eclipse IDE for C/C++ Developers (79 MB Windows 
An IDE for C/C++ developers with Mylyn integration. More... Mac Carbon 32bit 
Downloads: 124,856 Mac Cocoa 32bit 64bit 


Linux 32bit 64bit 


Opg 





Felinse INF for .lawa and Renort Nevelonerc (22N MRI Windows 


—m Y) 


alòwl المبين في الصورة‎ Eclipse Galileo «isl نا‎ 


P bem 
echHpse 


GALILEO 


Ws and others, 2000, 2009, All rights reserved. Java an 
re trademarks Or r ered trademark: 
iaspoar both. Eclipse is a trademark of the Eclips 





يتم تثبيت اكلبس بفك الأرشيف و وضعه في مكان معين داخل القرص الصلب 
فمثلاا يمكنك إنشاء Eclipse aow è lao‏ و تضعه في قرص الصلب : 
D:Neclipse‏ 





L sdk, لس‎ plugins LJ readme 
A «eclipseproduct > artifacts. xml 
Fichier ECLIPSEPRODUCT SQA] Document XML | exlipse.exe 
1 Ko zm| 253ko 





epl-v1ü.html 
Document HTML 
17 kn 


eclipsec exe 


^4. ecipse.ini 
z Paramètres de configuration 
— Ko 
ma 


Oy notice html 
Ei Document HTML 
7 Kn 


[^ 
2 


configuration dropins 


J 


ADT-0,9,3.zip 
317? Kn 


é v lili 


و بعد أن قمت بفك الملف المضغوط ,تصفح المجلد و أنقر مرة 
ainw, Eclipse.exe äga l‏ شحن الادوات اللازمة لتشغيل JI‏ 

ذالك ستظهر لك رسالة تطلب منك تحديد حيز العمل او ما sow‏ 
workspace‏ من الاحسن ان default,.bl.:cl a$ uo‏ 


T 
3 


في الضورة ببنة- peeks‏ البرمجيات. اكليس.و الجعروفة اختصار ]| ب 
IDE‏ : 


Oo eee MPU CM Pee cored CTI UA java - Eclipse 





File Edit Refactor Source Run Navigate Search Project Window Help 


fy" Gm : 9 B Ji b 1 O° Q -7 [ts Resource. Ci. DDMS &wa 8 9 jaya EE 

eee Pie bil 2-21“ 

i Project Explorer. £3 | = Fi) US) acting. java: 23 ET] 
= T, . package com.martilinio.tutorialü?2; ^ 


(ES Martilinio Tutorial 001 
5 g martilinia. tutorial. 02 
EE sre 


E- 8. com.martilinio. tutorial? 


*import android.app.àctivity;|] 
public class actilüz extends Activity | 
ImageView imLeft,imRight,imCenter; 
ImageButton imbLeft,imbRight; 





=- (I) actinz java TextView txtl; 
a at iub d: 

H gen [Generated Jaya Files] String 8; 
HBA Android 1.6 

E. assets /** Called when the activity is first created. */ 
Ce res (Override 

Ci. AndroidManifest xml A public void oncreateiBundle icicle] i 
B] default.properties super.oncreate [icicle] ; 


setcontentView[R.layout.maim|; 
txtl - [TextView] this.findViewvById([R.id.tst]; 





4 | imRight - [ImageView] this.findViewByIdiR.id.zmg right); 
sciens - men umm imcenter - [ImageVview) this.findViewById[R.id.imy center]; 
oE Outline 33 +. E] Task List L1 -" PA SOR ET ju am 
: imbLeft - [ImageButton) this.findViewByvId([R.id. img bieft); 
2 8 x e n in imbRight - [ImageButton] this.findViewByIdiR.id.imy bright); 
HB com martilinia tutoriali? : imbRight.setüonClickListener [new View.OncClickListeneri) { 
g^ import declarations 3 
3-9 تود‎ ١ | ! 
&  imLeft : ImageView JE] Tasks | E Properties H | ER BM U 
&  imRight : ImageView | Eo us i | 
&  imCenter : Imageview 
û  imbLeft : ImageButton 
4 jmbRight : ImageButton 
& tet: Textview 
à jint 
& 5: String 


[z^ 0 4 onCreate(Bundle] : void 
= G new OnClickListener[] 4...) 


me writable Smart Insert | 11:34 


لنتحدث قليلا عن تاريخ اكلبس, gr? oÀXg9‏ تم تطويرها من قبل شركة 
IBM‏ إبتداء من سنة 1996 و الهدف كان هو obi‏ تطبيقات خاص بها 
vous‏ بللغة جافا و لحمن Sa | EN‏ اء| من سنة 2004 تم طرح بيئة 
JAL 9 cgapha) gxaxiA Taw às jai Casa quitas Qe) uu quads.‏ 
تعديلات عليه دون قيود. نشير هنا ol‏ اكلبس يتعامل مع الاضافات PLUGIN‏ 
بشكل واسع حيث يمكنك برمجة احا ain sò luc adt‏ اكلبس و من ثما 
الشروع في برمجة تطبيقاتك المفضلة . 


C 


16 -2- 2- تحميل و تثبيت Nan‏ 


http: //code ab con/android/download. html 


der unt n" IS syl SU als ads 


Download the Android SDK 





All sdk: (aucun résulkat) 


October 2009 


The Android SOK has changed! If youve worked with the Android SOK before, you will notice several important differences: 
show more 


lf you are new to the Android SDK, please read the Quick Start, below, for an overview of how to install and set up the SDE. 


5 لاط قمتاطمع 1لا أقعذذل تا تأ0ن كك ”ركظ مقط Windows andraid-zdk. r3-windows.zip » 230/0805 bytes‏ 


ac OS # [intel] android-sdk ri-mac.zip 196534351 bytes f66/4bid5ebejbb1lesaf eho4f0c1d6, 
Linux (1556) android-sdk ra-linux.tqz 15966291 bytes  Jelizdeyfo165d154f51616f0dc1545c 


قم بفك الملف المضغوط pòs‏ بوضعه في مجلد جديد سميه 501 و الذي 


£ 


نم 
حي أن واج حو ماد اتليس نما وبين بي الصورة اسفله: 


D:'\eclipse 
Cù apache-ant-1.7.1 
C configuration 
















e 


jon des fichiers 
(_)dropins 


créer un nouveau dossier 
[Features 


Publier ce dossier sur le Web Lap? 
Lù plugins 
= 

_ readme 


Ss چ‎ 
eal .eclipseproduct 


= ADT-0.9.3.zip 
2 artifacts., xml 
== eclipse. exe 


“$ eclipse .ini 


"ecipsec.exe 


epl-v10. html 
notice., html 


^arbtager ce dossier 


es emplacements 


bisque local t(D:3 
“es documents 
Jocuments partagés 
aste de travail 


-avnris réseau 


* 


nile 


: الخطوة التالية هي‎ 
My Computer ¬ Properties -Advanced-Environment Variables 


D: \ecLipse\sdk\android-sdk-windows-1.6 r1\tools; 


Propriétés systéme 


Restauration du systéme | Mises à [aur automatiques 


Variables d'environnement 


variables utilisateur pour jaafar 
Modifier la variable systeme 


Valeur de la variable : orale enn ne eee ee ER] JÉ riYtool e 


variables systeme 


Variable Valeur 


ComSpec COMTI DOW Si systemse cmd, exe 

FP MO HOST C... NO 

NUMBER OF P... 1 
Windows MT 
CHUWIMNDOWSISvsbem3szYWwbem;c:Pra... 





حير 


أخيرا يجب تحميل إضافة اكلبس الخاصة بالأندرويد المعروف إختصارا ب 
ADT‏ 


و ادوات تطو ير اندرويد , تم ضعه في مجلد اكلبس. 


ADT 0.9.4 gADT-U.3.4 zip) 336/536 bytes 4cdecdé/AbzezaDUZ2ZaBabboY1fi ey d4: 
EL mn 


| 


و لكي يتم إضافته إلى بيئة اكلبس , نتبع الخطوات التالية: 


Eclipse » Help -Install new software-Add 


في الصور أسفله شرح لكيفية إضافة أدوات المتاحة لتطوير برمجيات 
أندرويد ADT‏ : 


FT E 


Available Software | | 
Select a site or enter the location of a site. 


Work with: | type or select a site sé 


Find more software by working with the 'Available Software Sites' preferences, 











i} Add Site 












Name 
[DO 1 Name: | android plugin 


Location: | http: [ Archive... [) 














نكنار TEM "WV i‏ : نح is‏ 
7 على اضافة اندرويد 








Details 
Show only the latest versions of available software [ ]Hide items that are already installed 
Group items by category What is already installed? 


Contact all update sites during install to find required software 


MAN 





C Install 


Available Software 


Check the items that you wish to install, 





Work with: | jar: file: /D: feclipse/ADT-0.9.3.zip!! 





Find more software by working with the ‘Available Software Sites' preferences. 











Name Version 

=| [¥] 000 Developer Tools 
«p. Android DDMS 0,9,3,v200909031112-12945 
xp Android Development Toc 0.9.3.v200909031112-12945 











Details 


Show only the latest versions of available software [ ]Hide items that are already installed 
Group items by category What is already installed? 


Contact all update sites during install to Find required software 





و الذي J» 1» oJ Lu o Liziog‏ 
و من اجل ذالك نتبع الخطوات التالية : 


IF Jawa EE - Eclipse 
File: Edit Refactor 


Open File... 


Rename... 
=") Refresh 


Convert Line Delimiters Ta 


Swikch Swarkspace 


Eag Import... 
wî Export... 


Properties 


AIE4-ShiFEA- T e 





Rum Mavigate Search Project windows Help 


- 2ه - هه - 


La 


he 


ريح اضرع بعاتم 





Eclipse -> Window -Preferences 


تم 


SDK x gja أ‎ 


الذي يوجد به 


ثم أنقر على زر التالي إلى أن يتم تثبت الإضافة أندرويد ۸01 على 


منصة اكلبس . 
Lol‏ فة | تدرو ند ADT‏ تم تثبيتها ,يجب إعادة تشغيل اكلبس بنقر على زر 


.Restart 


اكلبس يطلب تحديد موضع مجلد الإندرويد )90 


مجلد اكلبس و المسمى sdk‏ 


D: \ecLipse\sdk\android-sdk-windows-1.6 rl 


1 Preferences 


(4) General 
x EEN 
E- Ant 
(+) Data Management 
+) Help 
(+). Install/Update 
+) Java 
Java EE 
+) Plug-in Development 
+) Remote Systems 
+) Run/Debug 
+) Server 
+) Tasks 
+) Team 
Terminal 
+) Usage Data Collector 
Validation 
+ Web 
+) Web Services 
A XDoclet 
+)- XML 


Android 


Android Preferences 


SDK Location: ©_D:\eclipse\sdk\android-sdk-windows-1.6_r1 


Note: The list of SDK Targets below is only reloaded once you hit ‘Apply’ or 'OK'. 


Target Name vendor 
Android 1.5 
Android 1.6 
Google APIs 
Google APIs 


Google Inc. 
Google Inc. 


Android Open Source Project 


PlatForm 


Android Open Source Project 1.5 


1. 
1. 
1. 


A 
3 
4 
3 
4 


| | Browse... 


PI. 





Restore Defaults Apply 


في تطوير 





تطبيقات الاندرويد. 


نقر على زر التصفح و أختر المجلد 


— —s Y) 





3 











نظرة موجزة حول برنامج أندرويد 


PIEVE Go dwiis -1-3_‏ 
يتالف برنامج أندرويد من نواة لينكس من مجموعة من مكتبات 
مكتوبة بللغة C/C++‏ , في الصورة أسفله هذه العناصر المنقسمة الى 


APPLICATIONS APPLICATION FRAMEWORK NDROID RUNTIME 





1-التطبيقات Applications‏ هي التطبيقات الرئيسية التي تكون نظام 
تشغيل اندرويد و تسمى llli‏ اللب: 
Home ,Maps, Calendar , Browser , Contacts ,..‏ 


2-المكتبات 1153165 : يحتوي أندرويد على مجموعة من مكتبات مكتوبة 
بللغة C/C++‏ ,من بينها: 

.SSL الانترنت‎ a, la» 9 WebKit مكتبة لدعم متصفح‎ - 

- مكتبة لتحكم في البيانات «SQLite‏ 

- مكتبة الوسائط المتعددة لتحكم في الصوتيات و مقاطع الفيديو Media‏ 
- مكتبة لتحكم في الرسوميات و التي تضم كل SGL 9 OpenGL‏ . 

- مكتبة لتحكم في العرض .Surface Manager‏ 


3 -إطار عمل التطبيق يتيح clio‏ 01355 اللازمة لإنشاء تطبيق أندرويد 
و تسيير المصادر Ressource‏ واايضا التحكم بالمعدات .Hardware‏ 


4-نواة لينكس : هو الجزء الذي يضم السوائق أو الدرايفرات اللازمة 
للتحكم بالمعدات وتسير الطاقة و الذاكرة و كذالك لتحكم بالشبكة و 
walks‏ الحماية . 


5-أندرويد :Runtime‏ و يضم بدوره جزأين' 
-مكتبة لب :Core libraries xw g; YI‏ 


واتضم فئات مشتقة من لب جا فا و لكن معدة لتتناسب مع واجهة أندرويد 
ب هذه | Lia J‏ ت ضرور ية لتشغيل s a:‏ الجدرويد: 


: Dalvik Virtual Machine- 


هى BJYI‏ خيالية: ذورها هو تشغيل. تطبيقات. المكتوية بالا تذرويت ,9 gan‏ 
أن نقول DVM ol‏ هي نسخة محدودة الذاكرة للالة الخيالية جافا JWM‏ و 
التي اعدة للتتناسب مع بيئة أندرويد DVM é jo,‏ أنه لا يفرق من 
الناحية الاولوية عند التشغيل,بين تطبيقات سواء كانت خاصة بنظام 
الاك ال رس يم س alie‏ الس ني في عر عل إل عن 

Ly و التي هي عبارة عن ملف مضغوط ,9 عند فكه‎ .apk >| dio | ol 

bl‏ ما قار ع لا ا اد class‏ ا4 الي الا ال 
إستعملتها , فملف ذو إمتداد class.‏ هو عبارة عن ملف من نوع 


2-3- بعض aub‏ لتطوير برمجيات sl‏ 


يحتوى. صتذوق تطوير sag VI clamo n‏ على عديد من. الاذوات. التي Jé lw‏ 
ale Tostal‏ تطوبر تطييقان as lell‏ الخلوق اندرويد والدذي ale dans‏ 
نظام التشغيل اندرويد : 


1-المحاكي للهاتف الخلوي أندرويد 
2-العتاد اندرويد الافتراضي 0لا 
adbòl si -3‏ 

android alol -4 


:Android Emulator 29,251 soleJl al S UxoJI -1 


TWE o sell om 3 maye cs bcd sao e oe bns. aul] Gyeall yè‏ من 
صندوق glai‏ 4 البرمجيات | تدرو ند 1.6 Android SDK‏ . 


els‏ مزمزم لا 


2 Cem pm. 
way 


To-‏ وا {s Jo | le‏ 4| دا 2ا1 
o lw le |e |z v lu |1 Jo fr‏ 
کا ا ا را | |s |» |r je‏ ^ 
alz hedde u L de‏ 





هذا المحاكي للهاتف الخلوي أندرويد,يتيح للمبرمجين تطوير تطبيقات 
الهاتف الخلوي و tM‏ كما لو ان vii» gal» dol zia‏ | هذا 
المحاكي للهاتف الخلوي أندرويد يعتبر من أهم الأدوات التي تيسر 
mobs‏ تطبيقات |[ تدروجد. ,فمن خلال هذا المجاكي يمكن تطوير و تجزبة 
التطبيق. بدون إستعانة بالعتاد ,بل بجهاز إفتراضي يحاكي الهاتف 
الخلوي اندرويد رو لكن لتشغيل: .هذا المخاكن .يجب أولاا] تشاع G‏ يسمى 
552i] » Us JI‏ 355 الإفتراضي و المعروف — AVD‏ 9 الذي سنتحدت عنه بعد 


2-العتاد أندرويد الافتراضي SAVD‏ 


كما قلنا سابقا لكي يتم تشغيلٍ محاكي الهاتف الخلوي أندرويد 
c», Emulator‏ إنشاء العتاد اندرويد الإفتراضي و الذي من خلاله نحدد 
gs siaal‏ ارون الذي سنستعمله و بشكل عام يسمح لنا AVD‏ بعمل 
تعد يلات Emulator ,le‏ لكي يعمل حسب رغبتنا و "m‏ النوع الهاتف الذي 
نملكه و الذي بطبع يجب أن يدعم نظا م التشغيل أندرويد. 

لانشاء عتاد أندرويد إفتراضي ۸۷0 جديد يجب كتابة سطر الأوامر الاتية 
في برنامج نافذة الأوامر: 


CAWINDOWS system 32hcmd. exe‏ يد 


Microsoft Windows AP [version 5.1.2600] 
CG) Copyright 1985-26801 Microsoft Corp. 


GasDocuments and Settings’ jaafarfandroid create aud -n android vd -t 2 
Android 1.6 is a basic fHindroid platform. 
Do you wish to create a custom hardware profile (no yes 


Device ram size: The amount of physical RAM on the device. in megabytes. 
hw.ran5ize [96]:80 


Touch-screen support: Whether there is a touch screen or not on the device. 


hw.touch5creen [yes]:no 


Irack-ball support: Uhether there is a trackball on the device. 
hw.trackball [yves]:no 


Keyboard support: Whether the device has a QWERTY keyboard. 
hy. keyboard [ves]:no 


DPad support: Whether the device has DPad keys 
hu.dPad [uyesl:vyes 


GSM modem support: Uhether there is a GSM modem in the deuice. 
hu.qgzmModem [ves ]:yes 





سطر الأوامر المؤطر بخط أخضر يمكن من إنشاء عتاد أندرويد الأفتراضي 
الجديد ,لنشرح قليلٍ هذا السطر: 
10 : هو أيضا أداة لتطوير برمجيات أندرويد سنتحدث عنه لاحقا. 


£ 


ERAT اللازم لإنشاء عتاد اندرويد الافتراضي‎ 5»J| là» : Create avd 
اندرويد الافتراضي الجديد‎ vsi بوضع إسم‎ ess :-n android v 

مباشرة بعد هذه العبارة “N‏ 

won esu; :-t, 2‏ العدد الذي يدل على المعرف الإصدا ر من الإندرويد 
Je lag! G b,‏ مع إضذار 16 هن صتدوق تطوير البرمجيات أ درو 

android sdk 1.6‏ ,إذن فالعدد المطلوب هو 2 ,أن كان الاصدار هو 1”.5 


فالمعرف يسند اليه الرقم 1. 


و لمعرفة الإصدارات المثبتة على حاسوبنا مع علينا الى كتابة هذا 


السطر في برنامج نافذه الأوامر 
android list target‏ 


LS‏ تلاحظون ,الكتابة المؤطرة بالأخضر تعطي معلومات حول إصدار 1.6 من 


الأندرويد 


please use -help for more information 


G:xXDocuments and Settings*jaafar?»android list target 
Available Android targets: 


id: 


تتلائم مع متطلبات 


1 


Hame: Android 1.5 


Tupe: Platform 
API level: 3 
Revision: 
5 kins: 
E. 


i 


Hame: Android 1.6 
Tupe: Platform 
API level: 4 
Revision: 1 
Skins: WUGASS4. 


Hame: Google APIs 
Type = Add-On 
Vendor: Google Inc. 
Revision: 3 
Description: 
Based on Android 1.5 AFI le 
Libraries: 

* com.google.android.ma 


,الات رال 


Cma 


7 و‎ 
aw Li |, 


QqUGR-P. GUGR-L. HUGR-P. HUGAR-L. HUGR “default > 


Le is QUGA,. HUGA tdefault? 


Android + Google APIs 


uel 3» 





z. Jar? 


كما avd.Jlé la,L, Lilà‏ يمكن 
ها تفك الخلوي سواء yo‏ حيث الذا 


Ó 


و من أجل ذالك مع عليك الا كتابة YES‏ بجانب سطر الاوامر المؤطر بالاصفر 
Gul s‏ يالك إن ton af‏ إأنياط uds cines [15:9] ansant ole,‏ 


J 


Created AUD 


hu. 
hu. 


ge‏ لا يدعم جهاز 


الشاشة بمقياس 346348 بكسل و لا يدعم شاشة اللمس 


"android vd' based on 


camera=no 
led. .density=1i26 


dizk.cachePartition.zize-ZH 


hu. 


sdCard=yes 


disk. cachePartition=yes 
1. ke yboard=no 
J.audioOutput yes 
J.audiolInput=yes 
J.dPad=yes 
J.acce lerometer=no 
J.camera.maxlerticalPixels-32H 
!.9gps-yes 
J.touchS5creen=no 
"B RET iln 
J.battery=yes 
1.gsmModem=yes 


.trackBall=no 


1.camera.maxHorizontalPixe ls =320 


Documents and Settingsx jaafar»‏ : نا 





خلوي ما . 
aod LI Mins‏ بإنشاء عتاد إندرويد الافترا 


الكاميرا ,و 


الكيم العغديلاة التي تمه بها لتخصيض عناد | 
tala) sped‏ 


BSE] 


Android 1.6, with the following hardware config 





يجدر الاشارة هنا أنه من الممكن إنشاء العديد من العتاد أندرويد 
الافتراضي ليتلائم مع خصوصيات الأجهزة الهاتف التي تملكونها ,و من 
الممكن تشغيل المحاكي الهاتف الخلوي أندرويد و تحديد أسم العتاد 
أندرويد الافتراضي لكي يعطي إيحاء و كأنك تشتغل على جهازك الخلوي 
vla Las‏ 


لتشغيل محاكي الهاتف الخلوي أندرويد نستعمل سطر الاوامر الاتي : 


ea ال ل‎ EIS UEFA - emulator -avd android_vd 





Microsoft Windows AP Lyersion 5.1.26B8H] 
(2 Copyright 1985-2081 Microsoft Corp. 





GasDocuments and Settings+ jaafar+emulator -avd android vd 


و lol JÉ‏ نكتب العبارة الاتية: 
emulator -avd nameOfAndroidVirtualDevice‏ 


:adbalol-3 - 


يتجلى دور هذه الاداة في مأ Em‏ 
لاسي Rem‏ المحاكي أو العتاد من خلال إ قلاع و توقيف الخادم . 
aw-‏ العلفات من 9 الى الفحا كن أو العتاد. 
nd‏ إلغاء تثبي التطبيقات . 
Even ai Mè‏ ملف — sS LI J»15 marhaban.apk‏ أو lis)!‏ نستعمل 
الامر الاتي : 
adb install c:\..... marhaban. apk‏ 
le Sucks MTM‏ مهن العتاد أو ai Sil‏ الحاسوبك تستعمل الامر 


adb pull enpo emulator or device dir — 
: ملف من حاسوبك الى العتاد أو المحاكي‎ fuit DL Lied! في‎ 


adb push application computer dir emulator or device dir. !‏ 
أما أذا أردت أن تعرف التطبيقات المثبتة على المحاكي ,فما عليك الى 
EM 699 L Gia‏ جديدة و تتبع الخطوات ax. JU Jl‏ . 
اكتب الاأمر التالي ٠:‏ 
adb shell‏ 
غيير المسار إلى ملف التطبيقات في جذع 0313 و الذي هو 0313/300/ و 
ذالك عن طريق كتابة الامر التالي : 


# cd /data/app 


ae ree | rey rer ey ee ay اكثت: هذا‎ Moss] 

#1s 
AYI WAS حعيا رك مع عليلك آلا‎ e ei تطبيقا: ها‎ vwè ol dl ان‎ 
' التالي‎ 


#rm your application.apk 


لكي تترك هذه الاداة مع MI sèl dl ele‏ مر : 
#exit‏ 


‘android slol-4 


هذه الاداة هي مسؤلة عن تسيير العتاد أندرويد الافتراضي إضافة الى 
ذالك فهذه Slay!‏ هي المسؤلة عن إنشاء 9 le JD ei‏ مشروعك في غياب 
او عند asé‏ الجاجة: الى. استعمال.: Classe jeni Aa‏ هنل | كليس : 


مثلا أن لم يكن عندنا اكلبس مثبت في الحاسوب يمكن استعانة بنافذة 
الاوامر e‏ ديل مسشووع ‏ اتدوويد .و ذالك. alayi bu ales‏ 


android create project ١ 
--target 2 \ 

--name tutol\ 

--path ./tutol \ 

--activity act \ 

--package com.elbakkali.tutol 


E oF Lé ga JaYi bw!‏ لانشاء مشروع جديد. 

السطر الثاني هو رقم الاضدان فر اندرو ت ba‏ الول الي لاه 
سنستعمل الاصدار 1.6 من صندوق التطوير البرمجيات اندرويد. 
السطر الثالث يدل على إسم المشروع . 

السطر الرابع يدل على مكان إنشاء المشروع داخل القرص الصلب. 

c LIE T‏ و ا ul ws A MCI zu‏ رويد 
"Hw‏ اللازمة لتحكم في محتوى التطبيق و هي form L i‏ مثلاا 


"SEM ES M السطر‎ 


G:XDocuments and Settings*jaafar?»android create project *« ——target 2 * ——name tu 
tol \ --path ./tutol * —-actiuityu act * —-package com.elbakkali.tutol 

Created project directory: G:XDocuments and Settings+ jaafaritutol 

Created directory G:Documents and Settings*jaafar*«tutoli*src*com*«elbakkali*tutoi 


Added file G:«Documents and Settings*jaafar*tutoi*src*com*«elhakkali*tutoi*act.;ja 
TE: 


Created directory C:\Documents and Settings*jaafar*tutoi*gen*com*elbakkali*tutoi 


Created directory C:\Documents and Settings’jaafar’.tutol res 

Created directory C:\Documents and Settings’ jaafar*tutolbin 

Created directory C:\Documents and Settings*jaafar*.tutol’ libs 

Created directory C:\Documents and Settings*jaafar.tutolressvalues 
Added file et ed ee ee Ee eee eB 
Created directory C:\Documents and Settings*jaafar’.tutol res’ layout 
Hdded file G:«Documents and Settings*jaafar*tutoi*rezs*layaout*main.xml 


Added file G:«Documents and Settings*jaafar*-tutoi*findroidManifest.xml 

Added file GC:«Documents and Settings*;jaafar*tutoi*huild.xml 

Created directory C:\Documents and Settings*jaafar.tutoltests 

vires directory G:*Documents and Settings*jaafar*tutol*tests*src*com«elhbakkali 
tuto 

Added file G:«Documents and Settings*jaafar*tutoi*tests*«zrc*com*selhakkali*tutol* 
actlest. java 

Created directory C:xDocuments and Settings= jaafaritutolttestsxgenscomse lbakkali 
111 

Created directory C:\Documents and Settings’jaafartutol\tests\res 

Created directory C:xDocuments and ed ec | 

Created directory C:xDocuments and Settings+ jaafaritutolrtestaxlibs 

Added file G:«Documents and Settings*jaafar*tutoi*tezsts*findroidManifest.xml 
Added £ile G:«Documents and Settings*jaafar*tutoi*tezts*huild.xml 


C:\Documents and Settings jaafar> 





إن Led‏ باإستكشاف مجلد الذي soir‏ على المشروع الذي of lis Lb Lind‏ 
فسنجده يضم المجلدات الاتية: 


(2) GIDocuments and Settingsijaafaritutot 

























tion des fichiers 


Créer un nouveau dassier 


Publier ce dossier sur le Web (mò Mo 
res src tests 


åndroidManifest, xml | = | build. properties 


Document x MI Fichier PROPERTIES 
LN m 3 Li n 
1 Kü EE 1 FO 


Partager ce dossier 


build. xml 
| Document XML 


3 ko 


L 


ae. 


res emplacements 





jaafar 


default, properties 4 local. properties 
Fichier PROPERTIES Fichier PROPERTIES 


| Ka 9 1 ko 


Mes documents 


= 





Documents partagés 
Poste de travail 


Favoris réseau 


bolla sues . 795: Mb Aa 


: bin المجلد‎ 

يحتوي cale‏ ملف حزمة برنامجك الذي يحمل | apk) > | dio‏ .( و الذي تم 
LGT aua‏ من ملفات "s‏ يحتوي عليها برنامجك عن طزيق أداة 6م38 
ب يتم ل هذه الحزمة ues le‏ العا كن ومن بعت تتم دكا 
على الالة الخيالية "0۷ عن طريق إنشاء ملف تنفيذي ذو إمتداد (.dex)‏ 
من طرف الاداة ×ل. 


المجلد SrCc‏ " 
يحتوي على شيفرة مصدر البرنامج الذي كتبته و الذي يحمل امتداد « 
java‏ .<« 


المجلد 5ع : 

يحتوي على الاشياء التي ستستخدمها في برنامجك كالمظهر ,قيم نصية , 
الأيقونة بالصور. 

ius الول عا ان ادات قرعت‎ (di ا و‎ es 
الرئيسي‎ " Lo ye 9 «XML يحتوي على ملفات ذو الامتداد‎ : layout 
.main.xml 
مختلفة الت و اللون ءالخ‎ EL فتسوبة.‎ 249 alè jaret Value 
:يحتوي على الرسوميات كالايقونة و الصور الخلفية‎ 131 


: gen المجلد‎ 


يحتوي هذا المجلد على ملف يدعى ga R.java L‏ دوره هو عمل ربط بين 
لكف السا الي سه ها م الت كور في ete IAN‏ أمعداد 
xml‏ و شيفرة المصدر | AN às g XS a.‏ جا فا . 


إليكم مثال لهذا alot!‏ 


.AUTO-GENERATED FILE. DO NOT MODIFY */ 


* 


* This class was automatically generated by the 


* Sapt tool from he resource data at rounds It 
* should not be modified by hand. 
*/ 


package com.elbakkali.tutol; 


public final glass Ei 

publice statio final class attf 4 

j 

public Static final class idf 
public static final int bEn=OxTEG400007 

j 

PUbLLCG Static. tinal class. layout 4 
public. Static tinal qnt aoctasox7r0200005 
public. Static tinal ant. mMa1n=—O0x/£L020001; 


public static TIN Class SEEING 1 
public statie final Int app- ngme-Ox/r0250000; 
j 


نلاحظ أنه يتم تخصيص لكل مكون من مكونات تطبيقك سواء كان من نوع oe‏ 
أو sl 9 Ro‏ مكون واجهة المستخدم JE,‏ مكون من wb au Li‏ يعرف 
المكون. 





A 











كتابة أول برنامج بالأندرويد 
مثال : برنامج مرحبا 


-1-4- كيفية إنشاء مشروع أندرويد 

لإنشاء مشروع اندرويد جديد ,تتبع الخطوات التالية : 

إفتح برنامج اكلبس من خلال الضغط مرتين على الأيقونة ej,Eclipse,exe‏ 
ستظهر لك علبة الرسائل تطلب منك تحديد حيز العمل ,أتركه إعتباطي 
Mika, YI, Default‏ الولوج إلى منصة تطوير برمجيات اكلبس كما في 
الصورة alaw l‏ 










am [SKE n $: #00 4: :G7:6 0 :363J-07:09:2: 
Es [5 Resource 7 Java FE | a DOM à البرمجدات‎ FD نسدر غناك اندرو ند الافتراضى 4 ساو‎ 


اذهب الى 
file--»new--»other--»new--»android project‏ 
Select a wizard‏ 


Create a Java class 


Wizards: 














ci [E | 
Ey Interface 
ux Java Project 
$ Java Project from Existing Ant Buildfile 
Ls Plug-in Project 
AL General 
Evi Android 
Ju Android Test Project 
ef Android XML File 
H- Connection Profiles 
GES CVS 
H- Eclipse Modeling Framework, 















































es‏ أن تتفر على الزر اتهاةء سيتم عرض غلية الرسائل الفالية التى 
تطلب منك إدخال المعلومات الخاصة باسم كل من االمشروع ,التطبيق 


New Android Project 


New Android Project 


Creates 4 new Android Project resource. I Ci- 


Project name: | marzaban 








Cantents 
Ce Create new project in workspace 
C» Create project From existing source 


Lise default lacatian 


Build Target 


Target Name vendor Platform 


[ ] Android 1.5 Android Open Source Project 1.5 
Android 1.6 Android Open Source Project 


1. 
C] Google APIs Moogle Inc, 1. 
C] Google APIs Moogle Inc, 1 





Android + [adus APIs 


Properties 

Application name: marhaban 

Package name: com. elbakkali.marhaban 

Create Activity: activity _marhaban | 
Min SOK Version: 4 














D 


الآن اضغط على زر الإنهاء لإستكمال إنشاء مشروعك الجديد. 
مشروعك جاهز الان لتطوير ,تصفح منصة تطوير برمجيات اكلبس ثم انقر على 
package explorer , Ji‏ ,ستلاحظ ان مشروعك أندرويد مكون من شجيرة من 
المجلدات : 

.java على مصدر التطبيق ذو الإمتداد‎ Soir : Src- 

xlm و المكونات المذكورة في‎ at يلعب دور مهم في ر بط بين ملف‎ :gen- 
المستخدم :مثال‎ "i OTE مكون باضا فة هذا الترميز الى‎ 
button مكون الزر‎ 


«Button 
android: id='a+id/id button" 


/» 


Public: Static final Class: id f 
public: Static: tinal ant. cd PDUCCON=0X7T0400007 


- 355615 : يمكن إضافة إلى هذا المجلد ملفات متنوعة كملفات 
الخطوط ,ملفات الصوتية و الملفات المرئية 


pJi xml هذا المجلد على القيم النصية ,الأيقونة,ملف‎ goin : res- 
Sag. pa | بتنظيم المكونات داخل التطبيق‎ 


androidManifest.xml‏ : يحتوي هذا الملف على مجموعة من المعلومات حول 
طريقة تشغيل تطبيقك و السمة المستخدمة و تحديدالخدمات المسموح بها 
لتطبيقك 


لمكم هال لهذا les Nl.‏ 


«?"xml version="1.0" encoding="utf-8?> 
<manifest 
xmlns:android="http: //schemas.android.com/apk/res/android" 
package="com.elbakkali.poids ideal" 
android: versionCode="1" 
android: versionName="1.0"> 
<appLlication android: label="@string/app_name"> 
<activity android:name=".poids ideal" 
android: Label="@string/app_name"> 
«intent-filter- 
<action android: name="android.intent.action.MAIN" 
/> 
<category 
android: name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
«/application» 
</manifest> 





File Edit Refactor Source Run  PMavigabe Search F 


Pn BH o: cS gs do: 5-0 
FY | Zt Java | GA Resource 7 JavaEE ci DDMS 


Hi Package Explorer 23 Te Hierarchy 


ES ls arab keyboard 
[3] = el bakkali android kuto bidi 
GT! ici ici aL 
a-w i p 
+) em. SFC 
G64 gen [Generated Java Files] 
comm Android 1.6 
assets 
55 ka res 
a androidmManifest. xrnl 
default. properties 





ahs ane sve a‏ مسار ريف a‏ بجافا ,و بعد نقر 


package com.elbakkali.marhaban; 
import android.app.Activity; 
import android.os.Bundle; 


public class activity marhaban extends Activity { 
/** Called when the activity is first created. */ 
@aOverride 


public void onCreate(Bundle savedInstanceState) { 


super.onCreate(savedInstanceState); 
setContentView(R. layout. ); 


لنشرح قليلا كل سطر من هذا الترميز: 
#السطار الول :+ اس حرف مقروعل las tn ea ls | eh‏ 
- السطر الثاني و الثالث : المكتبات اللازمة لتشغيل تطبيقك و التى 


سيتم استدعائها عن طريق كلمة import‏ 
نحن Lib‏ سنستعمل نشاط احادي لهذا نستدا عي هذه المكتبة 


import android.app.Activity; 
لتذكير فالنشاط هي الفئة اللازمة لعرض مكونات واجهة المستخدم على‎ 
في للغات البرمجة اخرى.‎ form الشاشة و هو يقابل‎ 


إذا أردت أن تعمل مشروع متعدد النشاطات ,فما عليك إلا إستدعاء هذه 


import android.app.ActivityGroup; 


-السطر الرابع : goin‏ على الفئة الرئيسية المشتقة من 449 blait!‏ 
SE Activity‏ راف اجدرويد ol xs‏ يحتوي على الفئة رئيسة واحدة 

مشتقة من فئة النشاط و عدد لا يهم من فئات أخرى . 

النشاط هو فئة تتفاعل مع المستخدم بحيث تسهل عملية بناء التطبيق من 
A a‏ مكونات واجهة المستخدم 1لا كالازرار ,الصور ,محرر 


و ذلك ali‏ العبارة التالية: 
setContentView( ); |‏ 
المعيار View‏ يمكن أن يكون أي مكون من مكونات UI porimajl àgzlsg‏ أو 
.XML based UI LAYOUT Libs‏ 
Ji‏ :إستعمال مكون واجهة المستخدم من نوع النص TextView‏ 
TextView txt;‏ 
txt - new TextView(this );‏ 
setContentView( );‏ 
.XML based UI LAYOUT bibri Jleziwl: JUo‏ 
setContentView(R.layout.main);‏ 


لنرى ما هي أهمية هذه العبارة 


public void onCreate(Bundle savedInstanceState )‏ 
يتم إستدعاء هذه الطريقة عند إقلاع النشاط. 


الآن سنقوم بفتح ملف 13111.11 المرفوق مع مصدر الترميز جا فا 


G- mar Faban 

(2 src 

za gen [Generated Java Files] 
ES Android 1.6 

i assets 

GS res 

(4) LS drawable 


+ 


beet 





x] Ep 
a 4ndroidManifFest.:rml 
defauylt. proparties 


Ci main.xml 5 

TL CEES mS eee eee SIE A IE eee ee‏ كا 

“<LinearLayout xmlns:android="httpry schemas. android. com’ apk/res/android™ 
android:orientation="rerticai™ 
android: layout widths"fill parent" 
android: layout height="f1ill parent" 
> 

<TextvView 
android:layout width-"f:11 parent" 
android: layout height-"'wrap content" 
android:text-"Ustring/hello" 
Jo 

</LinearLayout> 


نشرح قليلا ملف main.xml‏ : 
lis J& ol bo‏ الملف يشبه ملف 1111 رحيث نلاحظ آنه يتكون من محفظات 
balise‏ > < >/< 
utf-8‏ : في تطبيقات اندرويد يتم إستعمال الترميز اليونيكود 

.xml . J| 5lale في‎ w L aco Lo 

LinearLayout‏ : هذا النوع من التخطيط يسمى بالتخطيط المستقيم دوره 
هو وضع المكونات واجهة المستخدم واحدة تلوى اخرى . بوجد انواع من 
تخطيطات أخرى $. «.RelativeLayout, TableLayout‏ 

Ša : Orientation‏ وضع مكونات واجهة المستخدم إما بشكل أفقي 
Vertical 5gaf ol Horizontal‏ . 

gyyf : layout width ,layout height‏ طول التخطيط او مكون واجهة 

المستخدم ; 

fill parent‏ : هي خاصية لملىء الشامل لطول أو عرض واجهة المستخدم 
wrap content‏ : هي خاصية لملىء جزئيء المتعلق بالمحتوى . 


«TextView 


هذه المحفظة خاصة بالمكون واجهة المستخدم من نوع نصي و الذي يقبل 
الخاصية التالية: الطول ,العرض,النص pus‏ 

J929 b‏ هذه العلامة 0 و هي د مم لحرفين '3' 9 d'‏ و التي هي كلمة 
g at ài j4 12509 U gl ad ais‏ التي تعني عند و دورها هو دلالة على 
مرجع الذي هو الكلمة التي تلي هذه العلامة ,هذه الكلمة ما هي إلا ملف 
string.xmi‏ الموجود في yourApp\res\values gjixjl‏ 

لنقوم ببعض التغييرات :سنغيير نص المسند لمكون واجهة المستخدم Qo‏ 
TextView ,»3 £33‏ 


قم بتعويض هذا السطر 

android: text="@string/hello " 

بهذا السطر 

android: text- “"mar7aban bikom " 

oy | 9‏ سنرى التنيجة ESSE‏ في الاسفل على layout‏ 


<i *“main.xml 2-3 


E ——"  — —— X" 
Density «A [(DEfauk S| Touch «#[iDefaulb | keybra جح‎ 


Editing config: default 


marnhaban bikonrn 


L= Layouts X 
[4A] &bsoluEsr as out 
EJ Dialer Filter 
[E] E-pandableLizEw... 
[E] FrameLlayouk 
[G] Gridvievw 
[Hi] HarizantalScrall... 
[I] Image Swikcher 
Line arLayout 
List¥iews 
F-1] raediacarntraoallier 
[R.] RadioiGraup 
[R.] RelativeLayout 
Scrallyiey. 

(EE. Slidinglrasyer 

LS Views Es 
e» SurFace'viev 
(iF) "j 
(GU View Stub 
was all 





تعرف أكثر على XML based UI layout àíià;‏ 
هي eXstensible Markup Language. avi‏ هي إختصار لجملة Lp XML‏ 
فا لوجه المشترك بير" بين اللغتين àxl] | 455 HTML, o G Là i Loa MS L Î 9D,‏ 
eY| axl) yo -SGML-Standard Generalized "Markup Language‏ 
إلى ان هناك عدة إختلافات o9 olx‏ 
حيث يمكن تعريف حا فظات ody à,s.» asl) HTML,‏ للغة -XML‏ 
٠‏ يلم إستعمال حا فظات شبه معر فة HTML‏ جديدة, بينما في 
التي HTML mew‏ بحفظ و نمدجة البيانات ,بخلاف mew XML àsLJ‏ للغة- 
. فقط بتشكيل و إظهار البيانات 
في النقط التالية )"× يمكن تحديد مزايا إستعمال تقنية 
Gl essa] aise dl yé lave‏ عن المجيط و A‏ 
ne‏ للإستعمال في الشبكة- 
Jaa.‏ الترميز اليونكود- 


بشكل صحيح ,هناك قواعد يجب مراعاتها من jwi) XML‏ يتم إستعمال ملف 


xml‏ السطر الأول. من. العملف. يحب ul‏ يكون. مغرف لملف: 


-b37l9 على الأقل. مجفظة‎ walaJl sgiz ol ox 
محفظة الإنهاء <30+> كل محفظة البدأ-‎ ve يجب‎ <tag/> jj 
الممكن الإستعمال الشكل المختصر للمحفظات و ذالك بإستخدام محفظة‎ 
واحدة و هي‎ >/130< 
المحفظات تأخد بعين الإعتبار حالة الحرف أي-‎ ©6355. 
' ' ها تين العلامتين ” ” أو‎ exe تكون داخل‎ yl wou gen ra! قيم‎ - 
من تقنية 171 و المسمات‎ aol نستعمل نسخة‎ Aus 524 في تطبيقات‎ 
XML based UI Layout 
سنجده كتالي‎ 131/0 .xml «le aia, Lied إن‎ 


<?xml version="1.0" encoding="utf-8"?> 

«LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android: layout width="fill parent" 
android: layout height="fill parent" 


أن 


> 
«/LinearLayout»‏ 
في LinearLayout, |i»‏ في هذا المثال تم امار مخطط من نوع خطي 
: المخطط يتم تنظيم المشاهد واحدة تلوى اخرى ,إليكم مثال على ذالك 
| 


Ten TextView ol JI ols‏ ثلاث — واجهة | نصي 
د "NT‏ 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
androld: layout width="fiil parent" 
androidilayout heighHt-"FTiJ!I parent" 


«TextView 
android:text= "red text" 
androld:gravity-"center horizontal" 
android:background= "#aa00oo" 
android: layout. width="fill parent” 
android:layout helgbLt-"wrap content" 


J > 


<TextView 
android:text="green text 
android:gravity-"cenier horizontal" 
android: background="#00aa00" 
android: layout. width="fill parent" 
apdroad:layout height-"wrap content" 


"m 


I> 


<TextView 
android:text-"blue text " 
androld:graviLty-"ocenter horizontal" 
android:background-"£0000aa" 
android: layout width-"fi11I parent" 
android:layout height-"wrap content" 


Pe 


«/LinearLayout» 





و بشكل عمودي نكتب الترميز الآتي 


«?xml version-"1.0" encoding-"utf-8"?» 

«LinearLayout xmlns:android-"http://schemas.android.com/apk/res/android" 
androldtorlentatlon-" center veriical" 
androidslayout width-"?:J77 parent" 
androidilayout height=" parent" 


«TextView 
android:text-"red text" 


abdroidrigravity-"center veriical" 

android:background= "#aa00oo" 

android: layout width="wrap content" 

apdroidrlayout helgbL- “ILLL parent” 
Is 


«TextView 
android:text="green text " 
androidrgraviLy-"vrenter vertical" 
android: background="#00aa00" 
android: layout. width="wrap content” 
android: layout bherght-"Iil]! parenc" 
Ja 


<TextView 
android:text-"blue text " 
apdrold:graviLy-"ocenter vertical" 
android:background-"£0000aa" 
android:layout width-"wrap content" 
android:layocut height=" "fili parent” 
> 


</LinearLayout> 


سترى ما يلي 


ed textgreen text an 





في الموضوع السابق ,قمنا بتعريف مكون واجهة المستخدم من نوع نصي 


TextView 
asj Y | بالطريقة‎ í 


“put TOM 
android:id="@+tid/btn" 
android: text="Button" 
android: layour widih="avein" 
androld:layout helght- "2UgIip" 
android:textColor="#aa0000" 
/> 
áolS يتم تصريح بمكون مشهد زر بكتابة‎ Button داخل محفظة ,و يتم‎ 
و منتهي 600010 إضافة خصائص إلى هذا المكون مسبوق بكلمة محجوزة‎ 
بعيم التي تأخدها تلك الخصائص بين علامتي التنصيص‎ 5 
ذبن ملف‎ èn, فاخل فلت السرا ا جلا ماب ,رامال وون در‎ 
لهذا المكون مغرف‎ mass بيج أن‎ Vole 10 و يتم دذاللك بالطريفة الانية‎ 
android:id="@tid/btn" 
اللون و القياس.‎ 
بالنسبة للون يمكن أن يأخد قيمة عل الأشكال الآتية:‎ 
RGBZ 
RRGGBB# 
ARGB# 
AARRGGBB# 


بالنسبة للقياس هناك أنواع التالية: 


هو قياس بالبكسل :<ام. 
هو قياس In : jw L‏ 


هو القياس بالنقطة و الذي يعادل 1/72 إنش : Pt‏ 
هو قياس يعتمد على الكثافة وحدة البكسل في الشاشة: م01. 


كتابة برنامج مرحبا بدون إستعانة بملف xml‏ 


يمكن: .آن. تكتب. نفس. البرتاهج 693 yann AF LWI‏ واجهة المسخدم من 
نوع main.xml «le J»1»5 TextView wo‏ و ذالك بتتبع المراحل الاتية 
- إ ستدعاء المكتبة الخاصة بمكون واجهة المستخدم من نوع نصي 
TextView‏ ,و ذالك بكتابة العبارة الاتية : 
import android.wideget.TextView;‏ 
- التصريح بمعرف الذي ستستخدمه من نوع نصي TextView‏ : 
TextView txt;‏ 
- | نشاء هذا المعرف من خلال هذه العبارة 
txt=new TextView(this);‏ 
- تحديد خاصية النص لهذا المكون النصي من خلال هذه العبارة 


txt.setText("marhaban");//comentaire 


- تمرير هذا مكون النصي الى شاشة العرض من خلال العبارة الاتية 
setContentView(txt);‏ 


و الآن الترميز الكامل لمصدر التطبيق المكتوب بجافا: 
package com.elbakkali.marhaban‏ 
import android.app.Activity;‏ 
import android.os.Bundle;‏ 
import‏ 
public class activity marhaban extends Activity (‏ 
Called when the activity is first created. */‏ **/ 


txt ; 
@Override 


public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 


txt=new TextView(this); 


setContentView(txt); 


} 


} 
àl»,s osl» ol‏ التنفيذ البرنامج و معاينته داخل محاكي الهاتف 
الخلوي 5,1 » Emulator‏ . 
DIS Bil yo 9‏ مع عليك إلا الضغط على الزر التالي: 


2 Resource ا ا ل كن‎ Eclipse 





He Ed Relato Source Pur Mavigste Search Project nd» Hela 


Mag: 3 2 Je + pe. (2; q- 73 dò Resource (OU GONE RD lava Q9 Java EE 
Mes? P[AWET Jodi 


ثم ستظهر لك نافذة تطلب منك تحديد طريقة تشغيل برنامجك ,يجب أن 
تختار 1]1631100مم848 28501010 . 


i^ Run As 


Seleck à vay Eo run 'mar 7abarn': 











TI 

Jo Android JUnit Test 
Java Applet 

Java Application 
JU JUnit Test 








Description 
Runs an Android Application 





Ju aiw s Console 


El Console. 11 m RET 
Android 

[1880-01-04 00:32:21 - marTaban]------------------------------ 

[1980-01-04 00:32:21 - marTaban]indroid Launch! 

[1980-01-04 00:32:21 - mar?aban]adb is running normally. 

[1960-01-04 00:32:21 - marvaban] Performing com.elbakkali.marhaban.activity marhaban activity launch 

[1980-01-04 00:32:22 - marTaban]lutomatic Target Mode: launching new emulator with compatible iVD 'avdlü6' 

[1980-01-04 00:32:22 - marTaban]Launehing a new emulator with Virtual Device 'avdlD06' 

[1980-01-04 00:33:11 - mar?aban]Mew emulator found: emulator-5554 

[1980-01-04 00:33:11 - mar7aban]Waiting for HOME ['android.process.aeore']| to be launched... 

[1980-01-04 00:34:31 - mar aban]emulator-5554 disconnected! Cancelling 'com.elbakkali.marhaban.activity marhaban activity launch'! 


+ | 


السطر بالاحمر يدل على فشل في بناء المشروع و تثبيته داخل المحاكي 
للهواتف الخلوية أاندرويد. 

و السبب هو إن اكلبس يحتل مساحة كبيرة من الذاكرة الافتراضية, يجب 
òsle]‏ تشغيل اداة adb‏ : 








IEEE Ig EN T 
| Applications | Processus | Performances || Mise en réseau | Utilisateurs | 





Nom de l'image Mom de l'utilisateur ^ Identificateur de session Processeur Util, mé... ^ 
emulator, exe jaafar ü oo 55 984 Ko 
adb. exe jaafar ü OU 412 ka 
eclipse.exe jaafar ü Ou 25 512 Ko 
soffice. bin jaafar ü oo 35 108 Ko 
soffice exe jaafar ü au 20 Ko 
SGStiMan. exe jaafar n 13 1 326 Ko 
wmiapsr'v exe SYSTEM n oo 644 ka 
DrvLsnr, exe jaafar n OU 176 ka 
explorer.exe jaafar ü Ou 4 968 Ko zi 
taskmgr exe jaafar ü oz 5 naa Ko 
Fraser Aer: iaaFar n ni Baa kn 


و لتجاوز ذالك : 
الحل الاول : هو Command öx L a‏ عن طريق تنفيد cmd jol‏ و a9 Lol‏ 


android adb start-server 


` الرسالة‎ ose تظهر لل‎ vl Jé po Vl Iam تضيق.‎ ol ox s 


[1950-01-04 00:33:11 - maraban] Waiting for HOME ['android.process.acore'| ta be launched... 


الحل الثاني : قبل أن تظهر لك الرسالة التي في الأعلى توجه إلى 
نا فذة 00۷15 ثم إضغط على Devices,;‏ ,ثم أذهب إلى القائمة التي على 


ا قصى اليمين و اضغط على زر Reset adb‏ . 


STE mar /aban/src/com/elbakkali/marhaban/activity_marhaban. java - Eclipse 





File Edit Refactor Source Run Navigate Search Project Window Help 





Lu BP Sut FOB BOX PAS e 
FÎ êj Java [jS Resoute 59 JavaEE | Qi DDMS | 
B Devices © #5 o B 
Name $F Debug Process | 
$È Update Threads 
J Update Heap 
1 Cause GC 
هنا‎ Ái Q stop Process 





DM screen Capture 


[J] activity marhaban.java 24 


: à J Lu JI ستظهر لك هذه‎ 


E Properties | 97 Outline j BÎ Console £ x bi r^ll- 
DDMS 
[1980-01-04 01:44:16 - DeviceMonitor]àdb connection Error:Une connexion existante a dů être fermée par l'hôte distant 


ate ol all UD asa aa Y‏ بقاء هذا التطبييق.. 


إلا أن بناء تطبيق ذو ذاكرة صغيرة كهذا قد يتطلب ما بين 4 إلى 10 


دقائق ! 

أي أنه يستهلك وقت طويلا ,قد يشعر ك بالتدمر ,فما هو الحل ؟ 
الحل بكل بساطة هو لاستعانة بنافذة الأوامر لإنجاز Met diis‏ 
معدودة ! 


sls! -2-4_‏ مشروع أندرويد عن طريق نافدة الاوامر 


يمكن الاستغناء عن منصة تطوير برمجيات اكلبس و إستعانة بسطر الاوامر 
لبناء التطبيق بسهولة ,إلا ان هناك عائق وحيد يتجلى في صعوبة كتابة 
مصدر الترميز جافا و ماف دو xml »l»zel‏ لان الكتابة ستتم بواسطة 
محرر النص عادي bloc- notes s‏ و الذي لا يدعم تقنية تسلسية الترميز 
و إكمال نص الترميز . 


الان سنتعامل مع bhw‏ الاوامر ,لكن يجب الاستعانة بادة تقوم باختبار صحة 
الهواتف الخلوية أندرويد 
هذه الأداة هي apache-ant-1.7.1:‏ 


و التي يمكن تحميلها على الموقع الأتي 


الان و بعد أن قمنا بتحميل هذه الاداة يجب تثبيتها ,و من أجل ذالك قم 
بفك | adol 9 boza! alo‏ إلى مجلد اكلبس ,ثم اضف جدع هذه الاداة 
إلى مسار النظام path‏ لكي TI DI an‏ اوامر هذه الاداةه ضمن 
الاوامر و Ju,‏ العمل ضمن بيئة ©]600501. 

ومن أجل ذالك تتبع الخطوات التالية: 
My Computer > Properties -Advanced-Environment Variables‏ 
ثئم اضف جذع المجلد الى المسار g path‏ لا تنسى نقطة فاصلة ” : " 
لكي يتم الفصل بين جذوع المختلفة 


Prapriétés système 





l Restauration du spstéme — | — Mises à jour automatiques — || 





| Variables d'environnement 


Modifier la variable systéme 


: 


Valeur dé la variable : 5_r1'tools; iecdipsevapache-ant-1. 7.1! 


“variables systéme 


variable valeur 
ComSpec CoWwIN Dow Si systems2 cmd exe 
FP Wo HOST a... No 
MLIMIBER OF P... 1 
Windows MT 
Ci WINDOW S Systema W bem: C Pra... 






































الان هذه الاداة جاهزة للعمل . 
سنقوم بانشاء مشروع اندرويد عن طريق سطر الاوامر ,و قد ذكرنا كيفية 


: لتذكير فقط‎ 
android create project ١ 
--target 2 \ 
--name ApplicationName` 
--path ./myApplication ١ 
--activity myActivity \ 
--package com.elbakkali.myApplication 


android create project \ 

-t 2 \ 

-n ApplicationName\ 

-p ./myApplication N 

-a myActivity \ 

-k com.elbakkali.myApplication 


Invite de commandes 


C:Documents and Settings-jaafar-.muylpplication-gen-com«elbakka pw 


C:Documents and Settings=s»= jaafarsayAipoplicatioan+. res 
C:Documents and Settinga=a= jaafarsayòipoplication+» bin 
C:Documents and Settings» jaafarsayvAipplication+ Llibs 
C:Documents and Settings» jaafarsayvAipplication+. ressvalyues 
Added file C:~ Documents and Settings» jaafarsayvAipplicat ion". ressyvaluvuesxstraiangs .xm l 


Created directory G: Documents and Settings» jaafarsanyApplication+ res» Layout 
i andl Sett ings™ JaafF ar™nyA pp Licat le oe ee LN - xm ÛL 

and Settings» jaafarsayvAipplaicationsAndroidManifest.xml 
and Settings jaafarsavAipplaication= build. »xmi1 

Created directory C:Documents and Settings» jaafarsamyAipplicationtesteae 

Created directory C:Documents and Settings jaafar=snmyApplication".testessroercom.e 

lbakkalisayAipplication 

Added file C:~ Documents and Settings» jaafarsavAipplication+tests»rsrescons.elbakkal 

ilsaviipplicationsayiActivitylest. java 

Created directory C:Documents and Settings» jaafar=smamyipplication"testeargencom.e 

lbakkalismayAipplication 

Created directory CG: Documents and Settings» jaafarsayAipplications.testerres 

Created directory G:5 Documents and &ettidingz^-jamnmfaur-muhpplicatdinon-teztz-hin 

Created directory C:Documents and £&ettdingz-jaafar-muhpnplicatainn'*"teztz-lihz 

Added file C:~^~ Documents and Settings» jaafarsavAipplicationstests-AindroidhKanifest. 

rr LUN B 

Added File LCL:zsDocuments and &ettangzjaemfar-muhpplicatinn"teztz-huaald.:xml 


= Documents and Settings»= jaaf ar » 





نعاين هذا المشروع داخل القرص الصلب :_ 


= C:\Documents and Settings\jaafar\myApplication 





Fichier Edition — Affichage Favoris Outils ? 


(Q) Précédente - d 7 Rechercher [^ Dossiers i” 


Adresse 5) C:\Documents and Settings\jaafar\myApplication 





sts 

default. properties áj E local.properties 
Fichier PROPERTIES P Fichier PROPERTIES 
1 Ko = 1 Ko 


Autres emplacements A e Document XM 
(2) jaafar 
(L) Mes documen ts 


(2) Documents partagés 
sj Poste de travail 


€ Favoris réseau 


=. st Lis ملف ترميز المصدر جا فا‎ ao, pon 
package com.elbakkali.myApplication; 


import android.app.Activity; 

import android.os.Bundle; 

import android.widget.TextView; 

public class myActivity extends Activity 


1 
/** Called when the activity is first created. */ 
@Override 
TextView txtv; 
public void onCreate(Bundle savedInstanceState) 
{ 
super.onCreate(savedInstanceState) ; 
txtv = new TextView(this); 
txtv.setText("marhaban "); 
setContentView(txtv); 
} 


p 
تواجد مشروعك عن طريق كتابة الامر‎ vle و غير الجذع الى‎ command e 


ais]‏ نافدة الاوامر 
chdir ./myApplication‏ 


قبل ذالك يجب تشغيل محاكي الهاتف عن طريق كتابة السطر الاتي: 
emulator -avd nameOfAndroidVirtualDevice‏ 
الان لبناء تطبيق انطلاقا من مشروعك نستعمل الامر si VI]‏ :— 


ant debug 


z5 Documents and &5Settingzs'-jaafar?^chüdir .«^muüHpplication 


z5 Documents and Settings= jaafarsamyApplication ant debuyg 
Buildfile: build.xml 

[setup] Project Target: Android 1.6 

[setup J] API level: 4 


Lecho] Creating output directories if needed... 
[mkdir]! Created dir: C:\Documents and Settings=s= jaafarsayApplication= bin=.c las 


l*ezonrcee-zrc- 
Lecho] Generating H.jaua #7 Manifest .java from the rezourcez... 


idl: 
Cechol] Compiling aidl files into Java classes... 


ompile= 
[javac] Compiling 2 source files to C:Documents and &ettinuyzs-jaafar.muftppli 
ation*bin*c lasses 


EE 
Lecho l Converting compiled files and external libraries into bin.-classe 


ackage—-resources: 
Lecho] Packaging resources 
Laaptexec] Creating full resource package... 


Greating ApplicationMame-debug-unaligned.apk and signing it with a 


Lapkbuilder] Using keystore: C:\Documents and Settings*jaafar™. android \debug.key 


tore 
Lapkbuilderl] C:\Documents and Settings*jaafar*.myApplication*bin*classes dex =? cC 


lasses dex 


ebug = 
[echo1 Running zip align on Final apk... 
Lecho] Debug Package: hinApplicat ionName-—debug.apk 


BUILD SUCCESSFUL 
otal time: 36 seconds 
:sDocument= and Settings= jaafarsayApplication » 





aJi مرحجلة التحميل هو تثبيت و ذالك بكتاية الاأمر‎ cele Isl s 


ant install 


=“ Documents and Settinge== jaafarsmayviipplication rant install 
tu ildAf ile: build.xml 

Csetupl] Project Target: Android 1.6 

[setup1 API level: 4 


irs: 

Lecho 1 Creating output directories if needed... 
ESource-—sirec 2 

[echo 1 Generating KRR.java . Hanifest.java From the resources... 


idl: 
Lecho 1 Gompiling aidi files into Java cllafses... 


P jer = 
Lecho 1 Converting compiled files and external libraries into Bbhinec lasses ide 


bac kage re sources=:= 
[echo 1 Packaging resources 
L[laaptexec 1 Creating Full resource package... 


ehug—sign: 


bac kage : 
apkhuilderl] Creating ApplicationKianme-dekbkug-unaligned.apk and signing it with a 


ehug key... 
apkbuilder] Using keystore: CGi:sDocuments and Settings» jaafar» andro id= debuy -key 


tore 
apkhuilderi1 C:Documents and Settings jaafar=myAapplication*hinsclasses dex =F c 


ASSES.dex 


Running zip align on final apkE... 
Debug Package: hin-Applicat ionName—debug-apk 


Installing bin.ApplicationkKame-—dekbug.apk onto default emilatoar... 
pho: «2atalocal”otapApplicationKiane-—dekhug . apk 


Success 
Lexec 1 4 KE-= ee ee ee لحار‎ 


FUILD SUCCESS FUL 


otal time: Si seconds 
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-3-4-استعمال العلبة الحوار و إنشاء الائحة 
- إستعمال علبة الرسائل: 
هناك ثلاث طرق لإنشاء علبة الحوار في تطبيقات الأندرويد: 


dialog themed activities,alertdialog,toast 
سنتحدث أولاا على المكون 108518 : هو عبارة عن مكون واجهة المستخدم‎ 
دوره عرض نص قصير.‎ 


كما يمكن أن يحتوي إضافة إلى نص على مكونات أخرى ,مثال على ذالك 
المشهد الذي يتحكم في درجة الصوت ,في الصورة اسفله و الذي هو عبارة 
عن علبة حوار من نوع y Toast‏ الذي يحتوي على اربع مكونات واجهة 
المستخدم : 





| OK | | Annuler | 





لإستدعاء مكون 10351 نكتب العبارة الآتية 


import android.widget.Toast; 


makeText (Context, text, time); 
هو المکان الذي سیعرض من خلاله هذا‎ context 
المكون و غالبا ما يكون خاصا بالنشاط‎ 
. هو النص الذي سيتم إظهاره في هذا المكون‎ text 
المدة التي سيتم عرض فيها هذا المكون و التي تاخد قيمتان:‎ time 
.0 أو بكل بساطة العدد‎ LENGTH SHORT - 
. 1 أو بكل بساطة العدد‎ LENGTH LONG - 
و أخيرا لعرض هذا المكون على الشاشة نستخدم الطريقة الاتية:‎ 
show(); 


au it! على‎ “marhaban”  oé yoi هذ | المثال سيقوم بعرض‎ 
. Toast  نوكم باستخدام‎ 


سنقوم بعمل تغييرات على مشروع الذي أنشأناه سابقا 


package com.elbakkali.myApplication; 
import android.app.Activity; 
import android.os.Bundle; 
import android.widget.Toast; 
import android.view.View; 
public class myActivity extends Activity 
{ 
@Override 
public void onCreate(Bundle savedInstanceState) 
{ 
super.onCreate(savedInstanceState); 
setContentView(R.layout.main); 
this.setTitle("activity toast"); 
Toast.makeText(myActivity. this, ''marhaban bikoum ",0).show(); 


} 
} 
iux adl ee les) ux Nul oue» mae لكي كم استعفال .مكوق 160836 .تشكل:‎ 


الخاصة في التحكم في المشاهد: 
import android.view. View;‏ 


eu‏ ان. تغخيير نص غنوان: التطييق بو ذالك يكتاية. العيارة الثالية: 
this.setTitle("activity toast");‏ 


بعد تنفيذ التطبيق نحصل على òjgaJil oi‏ 


Bil] 483 11:47 PM 


marhaban bikouni 





aia) و هو عبارة عن |متداد‎ alertDialog usSoJ! yo) sb vl 
دوره هو إظهار علبة الحوار و التي يمكن أن تحتوي على‎ Dialog 


بواسطة مكونات واجهة المستخدم .CheckBoxe,RadioButton Jû‏ 


ans YI òjlGLesl vis alertDialog ooS. لإستدعاء‎ 


import android.app.alertDialog; 


نستعمل هذه الطريقة لإنشاء البناء لهذا المكون: 


AlertDialog.Builder alertbuild - new AlertDialog.Builder(this); 
alertDialog 419 و قبل ذالك يجب إستدعاء الفئة الفرعية من‎ 


الخاصة ببناء علبة الحوار من نوع .alertD1al0g‏ 
و ذالك بإستدعاء هذه المكتبة: 


import android.app.alertDialog.Builder; 


هذه الطريقة تسمح بتحديد عنوان الرسالة مراد عرضها على الشاشة: 


alertbuild.setTitle("dialog title !"); 


هذه الطريقة تسمح بتحديد نص الرسالة مراد عرضها على aw Lit!‏ 
alertbuild.setMessage("alert dialogue example !");‏ 


لعرض علبة الرسائل هاته , نستعمل الطريقة الآتية: 


alertbuild.show(); 


والنختم هذا المحور بالتحدث عن طريق اخرى لإستعمال علبة الحوار و هي 
إستعمال. :ففهد. التشاط el‏ السا نلك فق :د الك من خلال 33255 خاصية. | لسمة 
Le DWE ei‏ ى ae WEI lobed) peas. AUS:‏ 
AndroidManifest.xml.slo ql‏ 
: محتوى هذا الملف يشبه هذا 
<?xml version="1.0" encoding="utf-8"?>‏ 
l.«manifest xmlns:android-"http://schemas.android.com/apk/res/android"‏ 
package-"com.elbakkali.your app"‏ .2 
android: versionCode="1"‏ .3 
android: versionName="1.0">‏ .4 
S. «application android: label="Qstring/app name"»‏ 
«activity android:name=".yourApp"‏ .6 
android:label="@string/app_name">‏ .7 
<intent-filter>‏ .8 
<action android:name="android.intent.action.MAIN" />‏ .9 
«category android:name="android.intent.category.LAUNCHER" />‏ .10 
«/intent-filter»‏ .11 
«/application»‏ .12 


13.«/manifest» 
هذه العبارة مباشرة بعد السطر السادس:‎ ad Lo L قم‎ 


android:theme-z"(android:style/Theme.Dialog" 


- إنشاء الائحة: 


لنتعرف أولا على دور الائحة : 
الائحة Menu;‏ هو مشهد يتيح لنا الولوج لمشاهد متعددة أخرى ,عندما 
بتار San eti!‏ ها تابه يه تشغيل النشاط الخاص بها 
يتم عرض الائحة من خلال الضغط على Menu yl‏ في المحاكي أو في الهاتف. 
في الصورة ,شاشة المحاكي كما تبدو عند الضغط على menu à-x; J| ,j;‏ : 


lI 5554:avd106 


m 


GEE b" aec na d زا‎ 
ow fe fe fr fy fu fr to fe- 


Ajouter Fond d'écran 


Qa @ Ti 


Rechercher Notifications | Paramétres 





Bl n i ds.‏ التالية 


import android.view.Menu; 
: و لا يجب أن ننسى إستدعاء المكتبة الخاصة بعناصر الائحة‎ 
import android.view.MenuItem; 


و أيضا المكتبة الخاصة بالمشهد,الأن شاشة العرض تتغير عندها نضغط على 
:menu , Ji‏ 


import android.view.View; 


کی کے Cadi aba aal aaa l aL‏ ج .ادرا شه 
eak‏ 


@Override 

public boolean onCreateOptionsMenu(Menu menu) { 

super.OnCreateOptionsMenu(menu) ; 

MenuItem menuItem =menu.add(id_ group,id item,order,caption item); 
return true; 


nogali aall aaa ALE yol wi JIS اضاقة. الى‎ 


@Override 
public boolean onOptionsItemSelected( Menu.Item item) [ 
switch (item.getItemId()) 


i 


case item l: your view 1; 
return true; 

case item 2: your view 2; 
return true; 


case item n: your view n ; 
return true; 


} 


return false; 
} £ £ 
يجب أن يكون عدد صحيح لأن‎ 1٤6۳_١۸ ,المعيار الثاني أي‎ bas 6, lw 
item n ,L; sa) تقبل فقط أعداد صحيحة كمعرف‎ case عبارة الشرطية‎ 


سنقوم باضافة لائحة تجتوي على عنصرين هما ”1 "number 2^" s$ "number‏ 
حيث عند الضغط على احدهما يتم انشاء نشاط جديد يحتوي على مكون 
واجهة المستخدم من نوع مشهد نصي /ا16111/1©6 كقيمة نصية ياخد اسم 


إليكم ترميز هذا التطبيق : 


package com.elbakkali.menu example; 
import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.view.Menu; 


import android.view.MenuIltem; 


import android.widget.TextView; 
public class activity menu extends Activity 


{ 


/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle icicle) 


{ 
super .onCreate (icicle) ; 
setContentView (R.layout.main) ; 


this.setTitle("elbakkali menu example"); 


} 
@Override 
public boolean onCreateOptionsMenu (Menu menu) { 
super .onCreateOptionsMenu (menu) ; 
menu.add(0,1,0,"number 1"); 
menu.add(0,2,0,"number 2"); 
return true; 


) 


@Override 


public boolean onOptionsItemSelected(Menultem item) 1 
switch (item.getItemId()) { 


case 1: 


TextView tvl = new TextView(this); 
tvl.setText("number one ! "); 


setContentView(tv1); 
return true; 
case 2 : 


TextView tv2 - new TextView(this); 
tv2.setText("number two ! "); 


setContentView(tv2); 


return true; 


j 


return false; 


j 
) 


. الائحة‎ pols io pais JS 9 20 wor Mow getltemid aa, JI 
PS. cenit ie A Green Mt iG dei s 
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number two ! number one ! 
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يمكن إضافة الأيقونة إلى عنصر من عناصر الائحة و ذالك بإستخدام 
الطريقة الآتية: 


setlcon(icon item n); 


سنقوم بإضافة هذا الترميز لكي يتم عرض عنصرين من الائحة و بكل واحدة 
منهما ايقونة خاصة بها . 


menu.add(0,1,0,"number 1") .setIcon(R.drawable.icon number 1) ; 
menu.add(0,2,0,"number 2") .setIcon(R.drawable.icon number 2); 


dile g Laged 9 icon number 1  , icon number 1 بيين‎ ia l Aid فم‎ 
res Ue JFlo 55-34! drawable 

يمكن أن تستعمل مثلاا GIMP Llogw JI zoli‏ لصنع هاته الأيقونات. 

للإشارة فقط ,فبرنامج أندرويد يدعم الصيغ الآتية الخاصة بالصور : 
BMP, PNG, GIF, JPEG.‏ 


و لاننا سنتغاجل مغ اشياء coi»‏ ملق برناهج التطبيق المكتوب بجافا' ; 
ox,‏ إستدعاء المكتبة الخاصة في التحكم في الموارد وهم 


import android.content.res; 


:SubMenu ä>x YI gò slwl- 


يمكن أنشاء فرع لأي عنصر من عناصر الائحة ,و ذالك في حالة إذا كان 
تطبيق يحتوي على أدوات كثيرة يلزم عرضها كعناصر من الائحة ,و من 
المعلوم أن عدد الاقصى من عناصر الائحة لا يتجاوز الستة ,هنا نرى إذن 
avan!‏ الا تحظ الفرعية. 

kay sa IT ai ki wou ael es sb) 


import android. view. SubMenu; 
ac ky الى لات ها‎ Ve Vi نتم‎ 
SubMenu your sub menu = menu.addSubMenu("your_ Submenu") ; 
و لإضافة عناصر إلى فرع الائحة ,يتم إستعمال الطريقة التالية‎ 


your sub menu.add("item 1"); 


your sub menu.add("item n"); 


إليكم هذا المثال التطبيقي 


package com.elbakkali.sub menu example; 
import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.view.Menu; 

import android.view.SubMenu; 


import android.view.MenuItem; 


import android.widget.TextView; 
public class activity sub menu extends Activity 
{ 
/** Called when the activity is first created. */ 
GOverride 
public void onCreate (Bundle icicle) 
{ 
super .onCreate (icicle) ; 
setContentView (R.layout.main) ; 


this.setTitle("elbakkali Submenu example"); 
} 
GOverride 
public boolean onCreateOptionsMenu (Menu menu) { 


super.onCreateOptionsMenu (menu); 

SubMenu sp - menu.addSubMenu(0,1,0,"liste des villes marocaine"); 
sp.add("Tetouan"); 

sp.add("Tanger"); 

sp.add("Martil"); 

sp.add("Ricon"); 

sp.add("Sebta"); 

return true; 

} 

} 


و بعد تنفيذ هذا التطبيق نحصل على ما يلي : 


ch Gi] 8 12:56 AM Bil] &3 12:55 AM 


elbakkali Submenu example — 
© liste des villes marocaine 


Tetouan 


subMenu example 


Tanger 


Martil 


Ricon 


Sebta 


liste des villes maracaine 





